home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / util / libs / asyncioppc.readme < prev    next >
Text File  |  2001-05-03  |  4KB  |  139 lines
  1. Short:    Asyncio.library with WarpOS functions (V40.4)
  2. Author:   achimste@gmx.de (Achim Stegemann)
  3. Uploader: achimste@gmx.de (Achim Stegemann)
  4. Version:  40.4
  5. Type:     util/libs
  6.  
  7. What was wrong in the last version ?
  8. Under WarpOS V5, the library caused an exception handler hit, if
  9. the handler was activated.
  10.  
  11. Notice:
  12. This archive is EMAIL-WARE !!
  13. ..what da hell is dis ??
  14. Simple... if you use it, simply send me a mail, so I know that
  15. someone is using it !!
  16. There is no copyright on it.
  17.  
  18. Requires:
  19. * MC68020 or PPC-board with WarpOS V4 (powerpc.library 15.0 or better)
  20.  
  21. Introduction:
  22. Many developer among you have used the asyncio.library, even me !
  23. The latest version of that one was V39.2. It is now some years old but
  24. still good for plain M68K Amigas.
  25.  
  26. I decided to continue developing the library for support of PPC-WOS.
  27. I bumped the lib-version to V40.
  28.  
  29.  
  30. Advantage of this enhanced asyncio.library:
  31.  
  32. *  You dont need a PPC to use this library. You can still access all
  33.    V39 functions from a plain 68k-Amiga.
  34.  
  35. The library is split in two parts:
  36. 1. The original V39-M68k functions ! I.e V40 is (of course)
  37.    100% compatible to V39 !
  38. 2. The V40 part contains all V39 functions but converted to WarpOS.
  39.    The functions have simply a "PPC" added to the name, e.g
  40.    OpenAsync (M68K) goes OpenAsyncPPC.
  41.  
  42.  
  43. Contents of the archive:
  44. The archive contains the FULL SOURCE code for StormC 3.0.
  45. You can use as a tutorial or whatever.
  46. I simply have taken the source from original V39 source and
  47. made the WOS port. That's all.
  48.  
  49. Also provided are include files for StormC !
  50.  
  51.  
  52. Developer information.. How to use it ?
  53.  
  54. The big advantage of asyncio_ppc is, that you can access a file from
  55. both CPU sides !!
  56. Example:
  57. * Open a file in 68k mode
  58. * Read datas in PPC mode
  59. * Close the file in 68k mode
  60. or whatever you like !!
  61.  
  62.  
  63. Usage of functions:
  64. It is important, that you must only use the M68k (V39) functions from
  65. the 68k side and you must only use the PPC-funtions (V40) from the PPC side.
  66. Example:
  67. M68k: file=OpenAsync("test",MODE_READ,8192);
  68. PPC:  ReadAsyncPPC(file,buf,1000);
  69. M68k: ReadAsync(file,buf,1000);
  70. M68k: CloseAsync(file);
  71. This one would be wrong:
  72. PPC:  WriteAsync(file,buf,len);
  73. or
  74. M68K: CloseAsyncPPC(file);
  75.  
  76. Understood ? Simple...
  77. SO don't mix up the functions !!
  78.  
  79. Note: It is important that you use several kBytes of buffer space, to avoid
  80. CPU switches ! The larger the buffer, the less switches !!
  81. I recommend using buffer between 16 kB and 64 kB.
  82. Larger buffers usually dont enhance speed anymore.
  83.  
  84.  
  85. Benchmark:
  86. In the source you can find a little "Test" program (CLI) for benchmark.
  87. Start "Test.wos" for WarpOS async and
  88. Start "Test.68k" for old function set.
  89. It will write a little file as "DH1:Test". Use Sushi to see
  90. the time.
  91. On my Amiga (604e/200 and 060/50) it shows 0.32 sec for the 68k and
  92. 0.17 sec for the PPC side.
  93. The difference is remarkable !!
  94.  
  95. Using asyncio V40 will give you no improvement, if you only use the
  96. V39 functions !!
  97.  
  98.  
  99. Tests:
  100. The asyncio.library has been successfully tested with the
  101. following programs:
  102. * Digital Almanac II
  103. * Digital Almanac III
  104. * AmigaAMP
  105. * AMPlifier
  106. * CyberQT
  107. * CyberAVI
  108. * ACTION (from OS 3.9)
  109.  
  110. Enhance your application NOW !!
  111. Feel free to use asyncio V40 as you like !!
  112.  
  113.  
  114. Internet: http://www.soft-ware.de/dalmanac
  115.  
  116.  
  117. ============================= Archive contents =============================
  118.  
  119. Original  Packed Ratio    Date     Time    Name
  120. -------- ------- ----- --------- --------  -------------
  121.     3271    1644 49.7% 04-Mar-01 19:02:50 +asyncioppc.readme
  122.     3812     782 79.4% 23-Oct-00 13:59:44 +asyncio_protos.h
  123.     1142     602 47.2% 23-Oct-00 13:59:44 +asyncio.h
  124.     1699     410 75.8% 23-Oct-00 13:59:44 +asyncio_lib.h
  125.    15676    6884 56.0% 04-Mar-01 19:02:56 +asyncio.library
  126.    12998    3125 75.9% 23-Oct-00 13:59:44 +async.c
  127.      681     367 46.1% 23-Oct-00 13:59:44 +async.h
  128.      806     277 65.6% 23-Oct-00 13:59:44 +asyncio.fd
  129.     1700     410 75.8% 23-Oct-00 13:59:44 +asyncio_lib.h
  130.    12904    3285 74.5% 04-Mar-01 19:04:04 +async_ppc.c
  131.      211     144 31.7% 23-Oct-00 13:59:44 +Lib.c
  132.     1034     442 57.2% 23-Oct-00 13:59:44 +ppcasyncio.¶
  133.     1862     614 67.0% 04-Mar-01 19:04:18 +ppcasyncio_ppc.¶
  134.     1323     485 63.3% 23-Oct-00 13:59:44 +test.¶
  135.     2584    1530 40.7% 23-Oct-00 13:59:44 +test.68k
  136.     5500    2418 56.0% 23-Oct-00 13:59:44 +test.wos
  137. -------- ------- ----- --------- --------
  138.    67203   23419 65.1% 05-Mar-101 06:37:10   16 files
  139.